home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / dviware / ln03 / rmcs / ginotosix.hlp (.txt) < prev    next >
LaTeX Document  |  1989-06-06  |  5KB  |  106 lines
  1. 1 GINOTOSIX
  2. Take a GINO psuedo-code file (produced using the SAVDRA driver) and create
  3. a sixel file in a format suitable for import into a LaTeX .LN3 file. The
  4. default action is to produce an image the same size and scale as the saved
  5. picture, using segment 0. The output filename is made from the supplied
  6. file-spec, with a type of .SIX. See the GINO documentation for more
  7. information on SAVDRA and picture segments, and the LaTeX user guides for
  8. more information on LaTeX.
  9. Format:
  10.       GINOTOSIX  file-spec
  11. To import the image into a LaTeX document, the \documentstyle option
  12. "graphics" should be used, and the command 
  13.       \gino(width,height){file-spec}
  14. inserted at the point where the image is wanted.  `width' and `height' 
  15. MUST be specified explicitly as lengths, e.g.
  16.       \gino(150mm,100mm){FRED.SIX}
  17. This program was written by Sqn Ldr Jon Baggott (2 MESE). As he has left
  18. the college, any problems should be directed towards Brian Hamilton Kelly
  19. (SEES).
  20. N.B. This command is NOT available by default; see Limitations below.  
  21. 2 Parameters
  22. file-spec
  23.   Specifies the name of the SAVDRA file. The default file type is .PIC
  24.   Wildcard characters are not allowed in the file specification.
  25. 2 Command_Qualifiers
  26. /SIZE
  27.   /SIZE=(option[,...])
  28.   Specifies the size (in millimetres) of the sixel image. If the qualifier
  29.   is not used, the default action is to copy the window size (or the paper
  30.   size if windowing is not in effect) of the saved picture segment.
  31.   WIDTH:n   specifies the width in mm of the sixel image.
  32.             Defaults to the saved width.
  33.   HEIGHT:n  specifies the height in mm of the sixel image.
  34.             Defaults to the saved height.
  35.   If only one option is specified, the parentheses may be omitted.
  36.   NOTE:     if this qualifier is used in conjunction with the /SCALE
  37.             qualifier, the action is first to scale, then window the
  38.             image. If the /SCALE qualifier is not given, the image is
  39.             scaled to fit the size specified. 
  40. /FORMFEED
  41.   /FORMFEED
  42.   /NOFORMFEED (default)
  43.   Instructs GINOTOSIX to append a formfeed to the end of the sixel file.
  44.   This allows the output file to be queued direct to a LN03 laser printer
  45.   for previewing. A formfeed must NOT be included if the file is to be
  46.   included in a LaTeX document. 
  47. /SCALE
  48.   /SCALE=x
  49.   Scale the stored image by a factor of x. The default scale factor is 1.0.
  50.   NOTE:     if this qualifier is used in conjunction with the /SIZE
  51.             qualifier, the action is to first scale, then window the
  52.             image. If the /SIZE qualifier is not given, the stored size is
  53.             scaled to produce the image size.
  54. /SEGMENT
  55.   /SEGMENT=n
  56.   Specifies the picture segment number in the SAVDRA file to use for
  57.   producing the image. The default value is 0. is not specified, the
  58.   maximum record length specified for the input file is used. 
  59. /OUTPUT
  60.   /OUTPUT=output-file-spec
  61.   Controls where the sixel file is written. The specification of
  62.   an output file is determined as follows:
  63.       NODE      - if the node is not specified, the current node is
  64.                   used. 
  65.       DEVICE    - if the device is not specified, the current default
  66.                   device is used. 
  67.       DIRECTORY - if the directory is not specified, the current
  68.                   default directory is used. 
  69.       NAME      - if the file name is not specified or is an asterisk
  70.                   wildcard, the name of the current input file is
  71.                   used. 
  72.       TYPE      - if the file type is not specified, or is an asterisk
  73.                   wildcard, the type of the file is set to .SIX
  74.       VERSION   - if the file version is not specified or is an
  75.                   asterisk wildcard, a version number of 0 is used. If
  76.                   a file with the same name and version number exists,
  77.                   GINOTOSIX will issue a (FORTRAN!) error message. 
  78.       
  79.   NOTE:  Wildcard characters are not permitted in the directory
  80.          specification.
  81. 2 Limitations
  82. GINOTOSIX only becomes available by defining it as a DCL command.
  83. To do this, you MUST execute the DCL command
  84.       SET COMMAND TEX$EXE:GINOTOSIX
  85. (just once) some time before issuing the GINOtosix command.  If you use 
  86. this facility regularly, you may care to put the SET COMMAND in your 
  87. LOGIN.COM file (somewhere after invoking @SYS$COM:LATEX).
  88. GINOTOSIX was written in VAX FORTRAN and uses GINO routines. Some errors
  89. are therefore trapped by FORTRAN or by GINO, rather than being handled
  90. correctly. 
  91. A scratch file is written and deleted in the default directory using the
  92. name "GINOTOSIX.TMP". Write access to the current default directory is 
  93. therefore required. 
  94. 2 Examples
  95. 1.   $ GINOTOSIX FRED
  96. GINOTOSIX will read the file FRED.PIC, and produce a file FRED.SIX from
  97. segment 0. The size of the sixel image will be the same as the saved
  98. picture. 
  99. 2.   $ GINOTOSIX/SCALE=0.5/OUTPUT=DISK$SCRATCH:[FRED]GRAPH.INC FRED.GNO
  100. GINOTOSIX will read FRED.GNO, and produce a half-size image in
  101. DISK$SCRATCH:[FRED]GRAPH.INC.
  102. 3.   $ GINOTOSIX/SIZE=(WIDTH:150,HEIGHT:100) FRED/SEGMENT=1/FORMFEED
  103. GINOTOSIX will read segment 1 of FRED.PIC, and uniformly scale the image
  104. to fit in a box 150mm wide and 100mm high. A formfeed will be appended to
  105. the end of the output file (FRED.SIX). 
  106.